home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat2 / setgroups.0 < prev    next >
Text File  |  1996-09-01  |  2KB  |  42 lines
  1.  
  2. SETGROUPS(2)               UNIX Programmer's Manual               SETGROUPS(2)
  3.  
  4. NNAAMMEE
  5.      sseettggrroouuppss - set group access list
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ppaarraamm..hh>>
  9.      ##iinncclluuddee <<uunniissttdd..hh>>
  10.  
  11.      _i_n_t
  12.      sseettggrroouuppss(_i_n_t _n_g_r_o_u_p_s, _c_o_n_s_t _g_i_d___t _*_g_i_d_s_e_t)
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      SSeettggrroouuppss() sets the group access list of the current user process ac-
  16.      cording to the array _g_i_d_s_e_t. The parameter _n_g_r_o_u_p_s indicates the number
  17.      of entries in the array and must be no more than {NGROUPS_MAX}.
  18.  
  19.      Only the super-user may set new groups.
  20.  
  21. RREETTUURRNN VVAALLUUEESS
  22.      A 0 value is returned on success, -1 on error, with an error code stored
  23.      in _e_r_r_n_o.
  24.  
  25. EERRRROORRSS
  26.      The sseettggrroouuppss() call will fail if:
  27.  
  28.      [EINVAL]      The value of _n_g_r_o_u_p_s is greater than {NGROUPS_MAX}.
  29.  
  30.      [EPERM]       The caller is not the super-user.
  31.  
  32.      [EFAULT]      The address specified for _g_i_d_s_e_t is outside the process ad-
  33.                    dress space.
  34.  
  35. SSEEEE AALLSSOO
  36.      getgroups(2),  initgroups(3)
  37.  
  38. HHIISSTTOORRYY
  39.      The sseettggrroouuppss() function call appeared in 4.2BSD.
  40.  
  41. 4.2 Berkeley Distribution       April 16, 1994                               1
  42.